home *** CD-ROM | disk | FTP | other *** search
/ World of Video / World of Video.iso / gfxprograms / 3dprograms / rayshade-4.0 / man / fbcat.man < prev    next >
Text File  |  1995-02-13  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. FBCAT(1)                                                 FBCAT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        fbcat - convert image format
  9.  
  10. SSYYNNOOPPSSIISS
  11.        fbcat [ -a<aspect> -t'title' -c'credits' ] [ -<type> ] [ image ] > image
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        A  general format converter.  It can read any of the known
  15.        formats and write one of the specified output formats (see
  16.        fbm(1)  for  format  details).  Note that some conversions
  17.        require more than simple format changes, such as color  to
  18.        grayscale  or grayscale to 1bit.  For these conversion you
  19.        must use a pipeline of ther commands.
  20.  
  21. OOPPTTIIOONNSS
  22.        --aa<<aassppeecctt>>
  23.               _a_s_p_e_c_t _r_a_t_i_o_, a floating point number which is  the
  24.               ratio  of the height of a pixel to its width.  Some
  25.               formats specify this, and for GIF images the reader
  26.               attempts to guess from the size of the image.  This
  27.               option overrides the input or guessed aspect ratio.
  28.               So if you know that your GIF image has a 1-1 aspect
  29.               ratio, you  should  specify  -a1  to  override  the
  30.               guess.
  31.  
  32.        --tt''ttiittllee''
  33.               _t_i_t_l_e_, specify a character string (up to 80 charac­
  34.               ters) to describe the image.   The  default  is  no
  35.               title.
  36.  
  37.        --cc''ccrreeddiittss''
  38.               _c_r_e_d_i_t_s  _o_r  _s_u_b_t_i_t_l_e_,  specify  a second character
  39.               string (up to 80 characters) to describe the image.
  40.               The default is no credit string.
  41.  
  42.        --BB     _f_a_c_e  format,  as used by Bennet Yee's _f_a_c_e program
  43.               at CMU.
  44.  
  45.        --FF     _F_B_M_, format (by default,  the  default).   You  are
  46.               guaranteed  not  to  lose information by specifying
  47.               FBM as the default.
  48.  
  49.        --GG     _G_I_F_, Compuserve GIF format.
  50.  
  51.        --II     _I_F_F format, interleaved  bitmaps  (ILBM),  used  by
  52.               Amigas.
  53.  
  54.        --PP     _P_B_M_, Jef Poskanzer's bitmap format.
  55.  
  56.        --RR     _R_L_E_, Utah RLE format.
  57.  
  58.        --SS     _s_u_n_, Sun rasterfiles (not run length encoded).
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                             25-Jun-90                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FBCAT(1)                                                 FBCAT(1)
  71.  
  72.  
  73. EEXXAAMMPPLLEE
  74.        To convert a GIF file to an IFF file
  75.  
  76.            % fbcat -I < foo.gif > foo.iff
  77.  
  78.        To  convert  a  Sun  raster  file to an FBM file, adding a
  79.        title:
  80.  
  81.            % fbcat -t'Title String' < bar.8bit > bar.fbm
  82.  
  83. SSEEEE AALLSSOO
  84.        fbm(1) for general discussion, pbm(1) for PBM routines.
  85.  
  86. BBUUGGSS
  87.        None known.
  88.  
  89. HHIISSTTOORRYY
  90.        Copyright (C) 1989,1990 by Michael Mauldin.  Permission is
  91.        granted  to use this file in whole or in part for any pur­
  92.        pose, educational, recreational  or  commercial,  provided
  93.        that  this  copyright  notice is retained unchanged.  This
  94.        software is available to all free of charge  by  anonymous
  95.        FTP and in the UUNET archives.
  96.  
  97.        25-Jun-90  Michael Mauldin at Carnegie Mellon University
  98.               Release 1.0 mlm@cs.cmu.edu
  99.  
  100.        07-Mar-89  Michael L. Mauldin at Carnegie Mellon Univer­
  101.               sity
  102.               Beta release (version 0.9) mlm@cs.cmu.edu
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                             25-Jun-90                           2
  131.  
  132.  
  133.